home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / C and C++ / Graphics⁄Sound / Star Stuff / star.notes < prev    next >
Text File  |  1986-03-15  |  5KB  |  78 lines
  1. Stars.
  2. Copyright 1986 by David Palmer
  3.  
  4.     This program prints a map of a region of the sky.  It has no menus, but
  5. it does have a dialog box, which places it in minimal conformance to the
  6. guidelines set out by The Newest Testament (Inside Mac).  It is independant
  7. of screen size, memory locations, etc., so it should run on just about anything,
  8. but I have only tried it on a Fat Mac-.
  9.  
  10.     To run this program, make sure that the files "star" (the application),
  11. "stars.cart" (the data file), and star.res are all on the same disk under these
  12. exact names, and then run "star".  The program will put up a dialog box for
  13. you to enter location, size, and format of the star chart.  The dialog box
  14. accepts decimal numbers, so you may enter an right ascension (R.A.) of 5h30m
  15. as 5.5h, simply by typing that number into the Hours box.
  16.  
  17.     The "Black Sky" box, when checked, causes the stars to appear as white
  18. spots on a black background.  When it is not checked, it gives black stars
  19. on a white background.  This is a better format if you want to print out the
  20. star map (using clover-shift-shiftlock-4) because it doesn't waste ribbon
  21. and comes out much clearer.
  22.  
  23.     Clicking the Label box gives the names of all stars brighter than the
  24. magnitude you give it.  These name are all six letters, the first three being
  25. an identifier, the second three being the constellation. Thus, Alpha Canis Majoris
  26. (Sirius) is given as ALPCMA.  This is lousy, stars should be given their proper
  27. names instead of an ALL CAPS identifier, but that is the format in the data file
  28. I have.  Changes are invited and welcome.
  29.  
  30.     North (towards Polaris) is always up, East (the direction of increasing right
  31. ascension) is always to the left.
  32.  
  33.     The star catalog has only 1573 stars, with few stars below magnitude 5.5.
  34. This is no great problem for me, since I live near L.A. and stars dimmer than
  35. magnitude ~3 are washed out by the "Aurora Angelinas" (the gaudy lights), but
  36. if anyone wants to extend the catalog, be my guest.  See the source code for
  37. details on the format of the star file.
  38.  
  39.     This program demonstrates two bugs in The DeSmet C compiler, which is what
  40. I used to write it (V 1.01).  Firstly, when casting a float to an int,
  41. the compiler rounds instead of truncating.  This caused great agony until I
  42. wrote the routine "int makeint(double)", which truncates its argument.  The
  43. second bug is far more serious.  Go into the source and search for the second
  44. occurance of the word "bug".  In the following lines, there is an expression
  45. of the form A=B +- (...)/C.  The +- is necessary, because otherwise the compiler
  46. generates bad code, leaving A with the value of B.  This is very bad.
  47.  
  48.     This program is Copyright 1986 by David Palmer (Mail code 220-47, Caltech,
  49. Pasadena, CA 91125) and may be given away and modified, but not sold.  (Users'
  50. groups may charge a small fee for distribution, but use for profit is a no-no)  The
  51. data in the data file is in the public domain, but I do not know where it originally
  52. came from.  It is distributed under the "Bread-On-Waters" system.  All major
  53. modifications and enhancements must be sent to the author in source form, and
  54. I will incorporate the worthwhile ones in the next version and distribute it the
  55. same way.  I reserve the right to charge $15 for a disk with the source on it,
  56. but the source and the compiled version will be freely distributable with only
  57. these same conditions attatched.  (i.e.  If you can get the source from a bulletin
  58. board, a club, a friend etc., you are free to do so.  I just don't want to spend
  59. all of my time copying disks.)
  60.  
  61.     Suggested enhancements include
  62.         1) Positions of planets, comets (enter your own elements), and the horizon
  63.         2) A Solar to sidereal converter, allowing the output to be output in
  64.             Alt-Azimuth form, with up up, left left, and right right.
  65.         3) Clicking on a certain point should move that point to the center of
  66.             the screen.  If you draw a box, the screen should zoom in on
  67.             that box.
  68.         4) Conversion to a better C compiler.
  69.  
  70.     Something which is not an enhancement, but which I would still like, is a
  71. phase of moon desk accessory, with a sidereal clock/Julian Calendar.  I don't
  72. know why I want one, but I do.
  73.  
  74.     Write those enhancements, and we will have a free planetarium for everyone
  75. to use.  People will start looking at the sky more and cutting down on light
  76. pollution.  A rising tide of pro-space sentiment will sweep humanity out into
  77. the infinite expanses of mankind's destiny.  Or at least we will have something
  78. to look at when the sky is too bright to see anything.